home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / pfm314.zip / PFMDOC.TXT < prev   
Text File  |  1993-03-10  |  102KB  |  2,576 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                           PFM INFORMATION MANUAL version 3.14
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                          Copyright Paul R. Culley 1983 to 1993
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                            PFM INFORMATION MANUAL    PAGE 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.         1 WHAT IS PFM?  . . . . . . . . . . . . . . . . . . . . . . . . .    5
  75.  
  76.         2 REQUIREMENTS FOR USE  . . . . . . . . . . . . . . . . . . . . .    5
  77.  
  78.         3 FIRST TIME INSTALLATION . . . . . . . . . . . . . . . . . . . .    5
  79.  
  80.         4 UPDATE INSTALLATION . . . . . . . . . . . . . . . . . . . . . .    6
  81.  
  82.         5 AFTER THE INSTALLATION  . . . . . . . . . . . . . . . . . . . .    7
  83.              5.1 Help . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  84.              5.2 Editor name  . . . . . . . . . . . . . . . . . . . . . .    7
  85.              5.3 Cursor configuration . . . . . . . . . . . . . . . . . .    7
  86.              5.4 Color choice . . . . . . . . . . . . . . . . . . . . . .    8
  87.              5.5 Your commands  . . . . . . . . . . . . . . . . . . . . .    8
  88.              5.6 [ESC], [Enter] begin normal operation  . . . . . . . . .    8
  89.  
  90.         6 OPERATION OF PFM (MAIN MENU)  . . . . . . . . . . . . . . . . .    8
  91.  
  92.         7 MAIN MENU SINGLE FILE COMMANDS  . . . . . . . . . . . . . . . .    9
  93.              7.1 Copy [FILES] . . . . . . . . . . . . . . . . . . . . . .    9
  94.              7.2 Copy [DIRECTORIES] . . . . . . . . . . . . . . . . . . .   11
  95.              7.3 Edit . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  96.              7.4 Attribute  . . . . . . . . . . . . . . . . . . . . . . .   12
  97.              7.5 More . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  98.              7.6 Time . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  99.              7.7 Delete [FILES] (use "D" key or "Delete" key) . . . . . .   13
  100.              7.8 Delete [DIRECTORIES] (use "D" key or "Delete" key) . . .   13
  101.              7.9 cOmmand  . . . . . . . . . . . . . . . . . . . . . . . .   14
  102.              7.10 Go or [Enter] . . . . . . . . . . . . . . . . . . . . .   15
  103.              7.11 Print . . . . . . . . . . . . . . . . . . . . . . . . .   15
  104.              7.12 Rename [FILES]  . . . . . . . . . . . . . . . . . . . .   15
  105.              7.13 Rename [DIRECTORIES]  . . . . . . . . . . . . . . . . .   16
  106.              7.14 Show  . . . . . . . . . . . . . . . . . . . . . . . . .   17
  107.              7.15 Your command  . . . . . . . . . . . . . . . . . . . . .   17
  108.              7.16 siZe [DIRECTORIES]  . . . . . . . . . . . . . . . . . .   17
  109.              7.17 Quit  . . . . . . . . . . . . . . . . . . . . . . . . .   17
  110.              7.18 Other command keys  . . . . . . . . . . . . . . . . . .   17
  111.  
  112.         8 MAIN MENU SPECIAL KEYS  . . . . . . . . . . . . . . . . . . . .   18
  113.              8.1 Function and cursor keys . . . . . . . . . . . . . . . .   18
  114.              8.2 ALT key Name search  . . . . . . . . . . . . . . . . . .   19
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                            PFM INFORMATION MANUAL    PAGE 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.         9 MULTIFILE OPERATIONS  . . . . . . . . . . . . . . . . . . . . .   19
  141.              9.1 Include/Exclude  . . . . . . . . . . . . . . . . . . . .   19
  142.                   9.1.1 Before  . . . . . . . . . . . . . . . . . . . . .   20
  143.                   9.1.2 After . . . . . . . . . . . . . . . . . . . . . .   20
  144.                   9.1.3 Ignore  . . . . . . . . . . . . . . . . . . . . .   20
  145.                   9.1.4 aTtribute . . . . . . . . . . . . . . . . . . . .   20
  146.                   9.1.5 Oldmarks  . . . . . . . . . . . . . . . . . . . .   20
  147.                   9.1.6 Wildcard filename . . . . . . . . . . . . . . . .   20
  148.              9.2 Multifile commands . . . . . . . . . . . . . . . . . . .   21
  149.                   9.2.1 Copy  . . . . . . . . . . . . . . . . . . . . . .   21
  150.                   9.2.2 Delete  . . . . . . . . . . . . . . . . . . . . .   21
  151.                   9.2.3 Attribute . . . . . . . . . . . . . . . . . . . .   21
  152.                   9.2.4 Time  . . . . . . . . . . . . . . . . . . . . . .   21
  153.                   9.2.5 cOmmand . . . . . . . . . . . . . . . . . . . . .   21
  154.                   9.2.6 Print . . . . . . . . . . . . . . . . . . . . . .   21
  155.                   9.2.7 Rename  . . . . . . . . . . . . . . . . . . . . .   21
  156.                   9.2.8 Your command  . . . . . . . . . . . . . . . . . .   21
  157.  
  158.         10 MORE MENU  . . . . . . . . . . . . . . . . . . . . . . . . . .   22
  159.              10.1 Show  . . . . . . . . . . . . . . . . . . . . . . . . .   22
  160.              10.2 Config PFM  . . . . . . . . . . . . . . . . . . . . . .   22
  161.              10.3 Edit  . . . . . . . . . . . . . . . . . . . . . . . . .   22
  162.              10.4 Make new Directory (MKDIR)  . . . . . . . . . . . . . .   22
  163.              10.5 siZe  . . . . . . . . . . . . . . . . . . . . . . . . .   22
  164.  
  165.         11 SORTING  . . . . . . . . . . . . . . . . . . . . . . . . . . .   23
  166.              11.1 Name  . . . . . . . . . . . . . . . . . . . . . . . . .   23
  167.              11.2 Extension . . . . . . . . . . . . . . . . . . . . . . .   23
  168.              11.3 Size  . . . . . . . . . . . . . . . . . . . . . . . . .   23
  169.              11.4 Time  . . . . . . . . . . . . . . . . . . . . . . . . .   23
  170.              11.5 Don't sort  . . . . . . . . . . . . . . . . . . . . . .   23
  171.  
  172.         12 PFM CONFIGURATION  . . . . . . . . . . . . . . . . . . . . . .   24
  173.              12.1 Help  . . . . . . . . . . . . . . . . . . . . . . . . .   24
  174.              12.2 Editor name . . . . . . . . . . . . . . . . . . . . . .   24
  175.              12.3 Cursor configuration  . . . . . . . . . . . . . . . . .   24
  176.              12.4 Color choice  . . . . . . . . . . . . . . . . . . . . .   24
  177.              12.5 Your commands . . . . . . . . . . . . . . . . . . . . .   25
  178.              12.6 [ESC], [Enter] begin normal operation . . . . . . . . .   25
  179.  
  180.         13 SHOW FILE  . . . . . . . . . . . . . . . . . . . . . . . . . .   26
  181.              13.1 Show file commands  . . . . . . . . . . . . . . . . . .   26
  182.                   13.1.1 Top  . . . . . . . . . . . . . . . . . . . . . .   26
  183.                   13.1.2 Bottom . . . . . . . . . . . . . . . . . . . . .   26
  184.                   13.1.3 Line size  . . . . . . . . . . . . . . . . . . .   26
  185.                   13.1.4 Quit . . . . . . . . . . . . . . . . . . . . . .   26
  186.                   13.1.5 +n lines . . . . . . . . . . . . . . . . . . . .   26
  187.                   13.1.6 -n lines . . . . . . . . . . . . . . . . . . . .   26
  188.                   13.1.7 Variable lines . . . . . . . . . . . . . . . . .   27
  189.                   13.1.8 Word Wrap  . . . . . . . . . . . . . . . . . . .   27
  190.                   13.1.9 Fixed lines  . . . . . . . . . . . . . . . . . .   27
  191.                   13.1.10 Showmode  . . . . . . . . . . . . . . . . . . .   27
  192.              13.2 Show file special keys  . . . . . . . . . . . . . . . .   27
  193.  
  194.  
  195.                            PFM INFORMATION MANUAL    PAGE 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.         14 YOUR COMMANDS  . . . . . . . . . . . . . . . . . . . . . . . .   29
  206.  
  207.         15 LINE EDITING . . . . . . . . . . . . . . . . . . . . . . . . .   30
  208.              15.1 Special line editing keys . . . . . . . . . . . . . . .   30
  209.              15.2 Line editing Function Keys  . . . . . . . . . . . . . .   31
  210.  
  211.         16 ERRORS . . . . . . . . . . . . . . . . . . . . . . . . . . . .   31
  212.  
  213.         17 REVISION HISTORY . . . . . . . . . . . . . . . . . . . . . . .   33
  214.  
  215.         18 IDEAS FOR FUTURE ENHANCEMENTS  . . . . . . . . . . . . . . . .   36
  216.  
  217.         19 NOTICE TO USERS  . . . . . . . . . . . . . . . . . . . . . . .   37
  218.  
  219.         20 INFORMATION ON SITE & DISTRIBUTION LICENSES  . . . . . . . . .   38
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                            PFM INFORMATION MANUAL    PAGE 4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.         1 WHAT IS PFM?
  273.  
  274.              PFM is a personal file management system to help you to deal with
  275.         DOS.  It is used to make common file maintenance chores easier and
  276.         faster.  PFM is a "Front End" for the DOS command processor.  It is a
  277.         visual directory maintenance tool with pointer and single character
  278.         menu driven interface.  It is many good things which users have
  279.         requested.  To find out more, read the rest of this manual, or, (If
  280.         you are like me) just start running it and see what it does.
  281.  
  282.         2 REQUIREMENTS FOR USE
  283.  
  284.  
  285.         *    MSDOS or PCDOS versions 2.0 or greater.
  286.         *    IBM pc's or compatible machines.
  287.         *    The IBM monochrome adapter, CGA, EGA, VGA or other color adapter
  288.              in the 80 column text mode, or an adapter that is compatible with
  289.              one of the above.  (Note that PFM.COM produces flicker with the
  290.              IBM CGA adapter, Compaq and other compatible's color adapters
  291.              work properly.  If you have an IBM CGA adapter use the file
  292.              IBMPFM.COM instead of PFM.COM.)  
  293.         *    PFM requires a minimum of a two disk system (or a system connect-
  294.              ed to a network) and is most useful with large (hard) disks.
  295.         *    128k to 640k of memory (more is better!)
  296.  
  297.         3 FIRST TIME INSTALLATION
  298.  
  299.              To install PFM on your disk, just copy it from the distribution
  300.         floppy to your disk.  If you already have a copy of PFM that you have
  301.         been using, put the new copy somewhere else (temporarily).  If (and
  302.         only if) you have an IBM color graphics adapter (CGA) then copy the
  303.         special IBM version of PFM to your disk using the standard DOS com-
  304.         mand;
  305.  
  306.              EXAMPLE:  copy a:ibmpfm.com c:pfm.com
  307.  
  308.         Otherwise, copy the standard version of PFM to your disk using the
  309.         standard DOS command;
  310.  
  311.              EXAMPLE:  copy a:pfm.com c:
  312.  
  313.         Then begin executing PFM as a command.
  314.  
  315.              EXAMPLE:  c:pfm
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                            PFM INFORMATION MANUAL    PAGE 5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.         When PFM starts up for the first time, it will display a sign-on
  338.         message and instruct you to enter the location where PFM has been
  339.         placed.  If you do not want to run PFM at this time, just hit [ESC] on
  340.         the keyboard to exit.  If you do, you should enter the entire path-
  341.         name, including the drive letter, the path and the filename of PFM
  342.         itself.  For example; if you placed PFM in the root directory on drive
  343.         C: your response would be;
  344.  
  345.              Enter the complete new pathname of PFM:  c:\pfm.com
  346.  
  347.         Note that the cursor, [Ins], and [Del] keys work for changing the
  348.         response.  PFM must remain in the drive where it is installed in order
  349.         for correct operation of the "Help" and "Configuration" facilities. 
  350.         If you move PFM or attempt to restart it from another drive, it will
  351.         ask the installation questions again.
  352.  
  353.         4 UPDATE INSTALLATION
  354.  
  355.              If you already have a copy of PFM that you have been using, then
  356.         you may want to do the update installation.  This allows you to keep
  357.         your old 'Y' commands and editor filename configuration information.
  358.              To install the update PFM on your disk, just copy it from the
  359.         distribution floppy to a temporary place on your disk (somewhere
  360.         different from where the old PFM resides).  If (and only if) you have
  361.         an IBM color graphics adapter (CGA) then copy the special IBM version
  362.         of PFM to your disk using the standard DOS command;
  363.  
  364.              EXAMPLE:  (old PFM version is at C:\PFM.COM)
  365.  
  366.                        copy a:ibmpfm.com c:\temp\pfm.com
  367.  
  368.         Otherwise, copy the standard version of PFM to your disk using the
  369.         standard DOS command;
  370.  
  371.              EXAMPLE:  copy a:pfm.com c:\temp
  372.  
  373.         Then begin executing PFM as a command.
  374.  
  375.              EXAMPLE:  c:\temp\pfm
  376.  
  377.         When PFM starts up for the first time, it will display a sign-on
  378.         message and instruct you to enter the location where PFM has been
  379.         placed.  If you do not want to run PFM at this time, just hit [ESC] on
  380.         the keyboard to exit.  If you do, you should enter the entire path-
  381.         name, including the drive letter, the path and the filename of the OLD
  382.         version of PFM.  For example; if you placed the update PFM in the temp
  383.         directory on drive C: and your old version was at the root, your
  384.         response would be;
  385.  
  386.              Enter the complete new pathname of PFM:  c:\pfm.com
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                            PFM INFORMATION MANUAL    PAGE 6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.         The update PFM will first examine your old PFM, pick up your config-
  404.         ured 'Y' commands and your editor pathname, configure itself with them
  405.         and then install itself at the old PFM's location.  The PFM.COM file
  406.         must remain in the drive where it is installed in order for correct
  407.         operation of commands and the "Help" and "Configuration" facilities. 
  408.         If you move PFM or remove it from it's installed location, then it
  409.         will be unable to restart itself after running a command.  If you move
  410.         the PFM.COM file and then quit and restart it, it will ask the instal-
  411.         lation questions again.
  412.  
  413.         5 AFTER THE INSTALLATION
  414.  
  415.              PFM will then put up it's title message and a prompt line asking
  416.         for you to hit one of the characters [H] for help, [E] for editor
  417.         name, [C] for color, [U] for cUrsor, [Y] for Your commands, or [ESC]
  418.         to exit from this menu.
  419.  
  420.         5.1 Help
  421.  
  422.              If you enter "H" a help screen will appear which will remind you
  423.         how to answer the other questions and configuration information.  (To
  424.         exit HELP, hit the [F10], [Enter], or [ESC] keys).
  425.  
  426.         5.2 Editor name
  427.  
  428.              If you enter "E", PFM asks the name of the text editor that you
  429.         generally use.
  430.              The requirements for the editor are that it be started as a
  431.         ".COM" or ".EXE" file, it must accept the file to be edited as a
  432.         command line input, and it must be able to locate it's own overlays
  433.         and help files (if any) when they are not on the current disk or in
  434.         the current directory.  The DOS editor EDLIN.COM can be used but there
  435.         are many better ones available (such as PMATE, Microsoft WORD, or
  436.         WordPerfect).
  437.              Enter the name and location of your editor as the example shows.
  438.         Remember to type the entire pathname including drive.
  439.  
  440.              Example:  Editor pathname: C:\DOS\EDLIN.COM
  441.  
  442.         This entry specifies the editor used by PFM when you want to edit a
  443.         file.
  444.  
  445.         5.3 Cursor configuration
  446.  
  447.              If you enter a "U" for cursor, then PFM asks is whether you want
  448.         to keep the original cursor provided by DOS when you return to DOS
  449.         later on.  Since I happen to like a large blinking cursor (the better
  450.         to find it on the screen) PFM will make the cursor that way unless you
  451.         specifically answer "Y" to this question.
  452.  
  453.              Example:  Keep original cursor? (Y/N): N
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                            PFM INFORMATION MANUAL    PAGE 7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.         5.4 Color choice
  470.  
  471.              If you enter a "C" for color choice, then PFM will put up several
  472.         lines of text in the current color scheme.  You are then asked if you
  473.         like the scheme.  If you do, answer "Y" to the question.  PFM then
  474.         uses the scheme from then on until you change it with another configu-
  475.         ration.  If you don't like the colors, answer "N".  There are several
  476.         choices of color schemes available, if you don't like any of them,
  477.         pick the one you hate the least and write me a letter describing what
  478.         you would like.  If you send lots of money and I am in a good mood,
  479.         maybe I'll add your scheme to an upcoming version of PFM.
  480.  
  481.         5.5 Your commands
  482.  
  483.              The remaining configuration item is "Y" for Your commands.  This
  484.         refers to the setup of your own special commands.  This is described
  485.         in detail in a later section (YOUR COMMANDS).  If you decide to try it
  486.         now, then you can get out by just hitting the "ESC" key.
  487.  
  488.              Example:  ESC or Your command Char?  [ESC]
  489.  
  490.  
  491.         5.6 [ESC], [Enter] begin normal operation
  492.  
  493.              If all of the other configuration items are to your liking, then
  494.         hit [ESC] or [Enter] from the menu line.  PFM then asks is if the
  495.         above configuration answers are correct. The answers to all these
  496.         questions and other settings will be saved with PFM if you answer "Y". 
  497.         If you don't answer "Y", then the answers will only last until you
  498.         quit.  (You can come back and change your mind later before you quit).
  499.  
  500.         PFM will now begin normal operation by displaying the sign-on adver-
  501.         tisement.  Hit [F10], [Enter], or [ESC] to begin operation and PFM
  502.         will display the main directory and menu screen.
  503.  
  504.         6 OPERATION OF PFM (MAIN MENU)
  505.  
  506.              After PFM is installed, it can be restarted by typing "PFM" on
  507.         the DOS command line.  Note that if you start PFM with a drive/path on
  508.         the command line that PFM will begin by displaying the indicated path. 
  509.         If you want a small reminder about some system function or perhaps a
  510.         personalization for your computer listed on the main screen of PFM,
  511.         then start PFM with the text of your reminder following a "/".
  512.  
  513.              Example: PFM c:\dos
  514.              Example: PFM  /Goodstuff Inc.
  515.  
  516.  
  517.         The main menu displayed by PFM consists of several sections.
  518.              The main section of the screen in the middle to the left is a
  519.         listing of the directory at the current drive/path.  This listing
  520.         contains the file names, sizes of the files, date and time of last
  521.         write, and the attributes of the files.  This listing is sorted in
  522.         some order (the initial order is alphabetic with extensions given
  523.         priority over names).  You can move the cursor to point to any entry
  524.  
  525.                            PFM INFORMATION MANUAL    PAGE 8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.         on this screen with the cursor keys.  If you get too close to the
  536.         beginning or the end, the display will scroll to show you more files
  537.         in the directory (as long as there are some more).
  538.              On the top line of the screen is a list of commands which are
  539.         available at the moment.  These commands are activated by hitting the
  540.         highlighted letter from each command (usually the first letter) on the
  541.         keyboard.  If that command works in the current situation, then it
  542.         will do it's thing.  If not, or if the command key is not legal, and
  543.         the key you hit is not one of your personal commands, then nothing
  544.         will happen, good or bad (No, bells, buzzes or error messages here!). 
  545.         Many of the commands act on the file that the cursor is next to
  546.         (pointing to) allowing you to do these commands on these files with
  547.         only a few keystrokes.
  548.              On the second line of the screen is the pathname of the current
  549.         drive and directory.
  550.              On the last line of the screen is a set of commands which are
  551.         activated by hitting the function keys (more on this later).
  552.              On the right side of the screen is some other miscellaneous
  553.         information about the directory and disk drive and the date and time.
  554.  
  555.         7 MAIN MENU SINGLE FILE COMMANDS
  556.  
  557.              Following are the commands which are activated from the main
  558.         menu. In general they will involve the file name that the cursor is
  559.         pointing to when the command is hit.  At this point I should note that
  560.         if you start something that you do not want to finish, just hit the
  561.         [ESC] key.  This will get you back to the main menu.
  562.              Many of the commands require some kind of typed in response.  To
  563.         make this easier, PFM supplies an initial input or saves your last
  564.         input to the response to save typing.  To edit these responses see the
  565.         section on LINE EDITING.
  566.  
  567.         7.1 Copy [FILES]
  568.  
  569.              Copy the pointed file to somewhere.  If the cursor is pointing to
  570.         a file, the following applies.  PFM will prompt you for a "destina-
  571.         tion".  This prompt may be answered with a complete pathname (drive,
  572.         path, file, ext) or just some of these. If an element is missing, then
  573.         PFM will assume the current pathname component for the missing ele-
  574.         ment.  You can also use wildcards ("?" or "*") as DOS does in the file
  575.         or extension portion of the pathname.  PFM behaves much like DOS in
  576.         all these examples.  Other keys available are [F1] (name; same as "*"
  577.         at beginning of filename), [F2] (name.ext; same as "*.*"), [F3]
  578.         (current directory), [F4] (current drive), [F5] (swap drive), and [F7]
  579.         (extension; same as "*" after the ".").  The PFM [F5] key allows you
  580.         to use the full pathname of the most recently referred to "SWAP"
  581.         directory (see [F7] key).  This option is used by hitting the [F5] key
  582.         in place of a drive and path.  PFM will then automatically replace the
  583.         funny character (up/down arrow) with the drive and pathname of the
  584.         swap directory.
  585.              If the destination of the copy is an explicit directory (the
  586.         destination string ends in "\") then the file will be placed there if
  587.         the directory exists.  If the destination is not explicit, then PFM
  588.         checks to see if it is a directory.  If it is, the file is copied with
  589.         the same name as the source to the destination directory.  If the
  590.  
  591.                            PFM INFORMATION MANUAL    PAGE 9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.         destination is not a directory, the file will be copied to the desti-
  602.         nation with a new file name (the last part of the destination).
  603.              In the following examples we will copy the file "test.123" from
  604.         the current drive/directory "c:\exam\" to several different places;
  605.  
  606.              a:             (to a:\xxx\test.123 if last dir accessed on a: was
  607.                             "xxx")
  608.              a:\            (to a:\test.123)
  609.              \ouch          (to c:\ouch if c: does not contain a dir called
  610.                             ouch)
  611.              \ouch          (to c:\ouch\test.123 if c: does contain a dir
  612.                             called ouch)
  613.              \ouch\         (to c:\ouch\test.123)
  614.              a:\*.          (to a:\test)
  615.              a:\*.xyz       (to a:\test.xyz)
  616.              a:\*           (to a:\test.123)
  617.              ?z*.?4?        (to c:\exam\tzst.143)
  618.              *.*            (to itself {an error})
  619.              [F1]           (to c:\exam\test.)
  620.              a:[F2]         (to a:\xxx\test.123 if last dir accessed on a: was
  621.                             "xxx")
  622.              a:[F3]         (to a:\exam\test.123 if directory "exam" exists on
  623.                             drive a:)
  624.              [F4]\          (to c:\test.123)
  625.              [F5]           (to a:\test.123 if the last accessed swap directo-
  626.                             ry was a:\)
  627.              [F7]           (to c:\exam\123.)
  628.  
  629.         When the destination has been fully specified, a return will cause the
  630.         file to be copied.  The destination file name will be displayed on the
  631.         second line of the screen and a "C" will appear where the cursor was
  632.         in the main part of the screen.  If an error occurs it will be dis-
  633.         played at the top of the screen.  Note: Since copying a file to itself
  634.         would erase most of the file, PFM considers this an error and does
  635.         it's best to prevent this occurrence.  PFM saves the last several copy
  636.         destinations for you.  To use them, hit the up-arrow and/or down-arrow
  637.         keys to find the one you want.
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                           PFM INFORMATION MANUAL    PAGE 10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.         7.2 Copy [DIRECTORIES]
  669.  
  670.              Copy the pointed directory to somewhere.  If the cursor is
  671.         pointing to a Directory when you hit "C" for copy, then the following
  672.         applies.  PFM will prompt you for a "destination".  This prompt may be
  673.         answered with a complete directory pathname (drive and path) or just
  674.         the drive or path. If an element is missing, then PFM will assume the
  675.         current pathname component for the missing element.
  676.              The entire directory will be copied from the current location to
  677.         the destination.  If there are files, they will be copied.  If there
  678.         are subdirectories, then they and all of their files will be copied. 
  679.         Copying the special directory "." results in copying all of the files
  680.         at the current directory level as well as any subdirectories.  This is
  681.         especially useful for the root directory of a drive.  PFM tries to
  682.         prevent you from copying into a subdirectory of the current directory
  683.         (this would result in what is called infinite recursion or more likely
  684.         a "disk full" error as the same files were copied deeper and deeper
  685.         into the subdirectory tree).
  686.              If the destination of the copy is an explicit directory (the
  687.         destination string ends in "\") then the copied directory will be
  688.         placed there if the destination directory exists.  If the destination
  689.         is not explicit, then PFM checks to see if it is a directory.  If it
  690.         is, the source directory is copied with it's original name to the
  691.         destination directory.  If the destination is not a directory, the
  692.         source directory will be copied to the destination with a new name
  693.         (the last part of the destination).
  694.              PFM's directory copy behaves much like the DOS XCOPY command. 
  695.         Some special keys available are [F1] (dir name), [F2] (name.ext), [F3]
  696.         (current directory), [F4] (current drive), [F5] (swap drive), and [F7]
  697.         (extension).  The PFM [F5] key allows you to use the full pathname of
  698.         the most recently referred to "SWAP" directory (see main menu [F7]
  699.         key).  This option is used by hitting the [F5] key in place of a drive
  700.         and path.  PFM will then automatically replace the funny character
  701.         (up/down arrow) with the drive and pathname of the swap directory.  In
  702.         the following examples we will copy the directory "test.123" from the
  703.         current drive/directory "c:\exam\" to several different places;
  704.  
  705.              a:             (to a:\xxx\test.123 if last dir accessed on a: was
  706.                             "xxx")
  707.              a:\            (to a:\test.123)
  708.              \ouch          (to c:\ouch if c: does not contain a dir called
  709.                             ouch)
  710.              \ouch          (to c:\ouch\test.123 if c: does contain a dir
  711.                             called ouch)
  712.              \ouch\         (to c:\ouch\test.123)
  713.              [F1]           (to c:\exam\test.)
  714.              a:[F2]         (to a:\xxx\test.123 if last dir accessed on a: was
  715.                             "xxx")
  716.              a:[F3]         (to a:\exam\test.123 if directory "exam" exists on
  717.                             drive a:)
  718.              [F4]\          (to c:\test.123)
  719.              [F5]           (to a:\test.123 if the last accessed swap directo-
  720.                             ry was a:\)
  721.              [F7]           (to c:\exam\123.)
  722.  
  723.                           PFM INFORMATION MANUAL    PAGE 11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.         When the destination has been fully specified, a return will cause the
  734.         directory to be copied.  The destination directory and file name will
  735.         be displayed on the second line of the screen and a "C" will appear
  736.         where the cursor was in the main part of the screen.  If an error
  737.         occurs it will be displayed at the top of the screen.  PFM saves the
  738.         last several copy destinations for you.  To use them, hit the up-arrow
  739.         and/or down-arrow keys to find the one you want.
  740.  
  741.              Note: DOS and PFM only allow a directory tree to go to a
  742.              certain depth, the depth that can be displayed in 63 charac-
  743.              ters.  In addition PFM limits the number of directories in a
  744.              tree to 12 deep.  Attempts to create (via directory copy)
  745.              trees deeper than this will result in PFM producing an error
  746.              [8] "Insufficient memory".  The tree will be copied up to
  747.              the point of failure.
  748.  
  749.         For example; if the directory "c:\wxyz" contains the subdirectories
  750.              "abcdef\ghijkl\mnopqr\stuvwx\yzabcd\efghij"
  751.         so that the total path of the last subdirectory was
  752.              "c:\wxyz\abcdef\ghijkl\mnopqr\stuvwx\yzabcd\efghij"
  753.         for a total depth of 7 directories and 49 characters, then copying
  754.         "c:\wxyz" to the directory "d:\123456\789012\345678" will result in
  755.         problems because the total depth of the combined result would be 70
  756.         characters long.  The 15 level depth could only occur if the average
  757.         directory name at each level was 3 characters or less.
  758.  
  759.         7.3 Edit
  760.  
  761.              Edit the pointed file with your editor.  PFM starts up your
  762.         editor on this file name.  When you are done editing quit the edit and
  763.         PFM will restart right where it left off (Neat Huh?) Note that Write-
  764.         protected or Hidden/System files may not be editable by your editor.
  765.  
  766.         7.4 Attribute
  767.  
  768.              Change the file attributes of the file.  The attributes of a file
  769.         are displayed in the main part of the screen as follows: "B" not
  770.         backed up, "D" directory, "W" write protected, "S" system type, "H"
  771.         hidden.  The Backup, Write protect, Hidden and System attributes may
  772.         be changed.  PFM prompts you with a line as follows:
  773.  
  774.                   B= W= H= S=
  775.  
  776.         To add an attribute, change the "=" to a "+".  To remove an attribute
  777.         change the "=" to a "-", or use the "=" to leave it as it is.
  778.  
  779.         7.5 More
  780.  
  781.              Allows operations not related to the displayed directory. Use to
  782.         config PFM, edit a new file, make a new directory, or show a pathname. 
  783.         See the MORE MENU section for details.
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                           PFM INFORMATION MANUAL    PAGE 12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.         7.6 Time
  801.  
  802.              Change the file's date and time.  The date and time of a file are
  803.         displayed in the main part of the screen.  PFM prompts you with a line
  804.         as follows:
  805.  
  806.                   Date/Time: 07-30-90, 12:00:00
  807.  
  808.         You cannot change the date or time of a write protected file.  If a
  809.         file is write protected (a "W" in the attributes column) then an error
  810.         will occur.  In this case use the Attribute command to first un-
  811.         protect the file.
  812.  
  813.         7.7 Delete [FILES] (use "D" key or "Delete" key)
  814.  
  815.               Delete a pointed file.  You must answer the "Are you sure"
  816.         prompt with a "Y" to actually delete the file.  If a file is write
  817.         protected (a "W" in the attributes column) then an error will occur. 
  818.         In this case use the Attribute command to first un-protect the file.
  819.  
  820.         7.8 Delete [DIRECTORIES] (use "D" key or "Delete" key)
  821.  
  822.               Delete a pointed directory.  You must answer the "Are you sure"
  823.         prompt with a "Y" to actually delete the directory.  If the directory
  824.         contains files, an additional question is asked "Totally erase a Non-
  825.         empty directory [Affirmative/Negative]?"  You must respond with an "A"
  826.         if you really want to delete it.  If the directory contains any
  827.         subdirectories, they will also be deleted.  Deleting the special
  828.         directory "." results in deleting all of the files at the current
  829.         directory level as well as any subdirectories.  Deleting the special
  830.         directory ".." does nothing (for protection against unwanted deletes).
  831.  
  832.              Warning: Deleting the "." directory in the root of a drive
  833.              (i.e. C:\) will remove ALL of the files on the drive.  It is
  834.              not possible to recover from this operation (Short of time
  835.              consuming and careful use of a program like Norton Utili-
  836.              ties).  Even with such utility, it may not be possible!
  837.  
  838.              Note: even if files in the directory or subdirectory are
  839.              WRITE-PROTECTED, they will still be DELETED!
  840.  
  841.              Note: DOS and PFM only allow a directory tree to go to a
  842.              certain depth, the depth that can be displayed in 63 charac-
  843.              ters.  In addition PFM limits the number of directories in a
  844.              tree to 12 deep.  Attempts to delete (via directory delete)
  845.              trees deeper than this will result in PFM producing an error
  846.              [8] "Insufficient memory".  The files in the tree will be
  847.              deleted up to the point of failure, continuing to delete the
  848.              unfinished directories past this point will eventually allow
  849.              a complete delete.
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                           PFM INFORMATION MANUAL    PAGE 13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.         7.9 cOmmand
  867.  
  868.              Allows the execution of DOS commands.  PFM prompts for the text
  869.         of the DOS command.  A blank entry will activate DOS until the DOS
  870.         "EXIT" command is entered so that you can temporarily use DOS as you
  871.         used to.  If you try to run a "TSR" (Terminate and Stay Resident)
  872.         program from PFM, then PFM will have to remove it before continuing. 
  873.         It will give you the following message before removing the command
  874.         however;
  875.  
  876.         "* Error 24: TSR in memory, Hit the 'ESC' key to have PFM remove it *"
  877.  
  878.         After hitting the ESC key PFM returns to normal operation.
  879.              When entering the command string, you can specify portions of the
  880.         current (pointed to) pathname by entering on of the keys [F1] to [F4]. 
  881.         Use the [F1] key for the first part of a filename, and the [F2] key
  882.         for the entire file name and the [F7] key for the extension.  If you
  883.         want to include the current path or drive in the command string, use
  884.         the [F3] and/or [F4] keys.  The [F5] key is used to refer to the
  885.         "SWAP" directory path (the last directory you looked at with the [F7]
  886.         key).  If you do not want to see a "Hit any key to continue" message
  887.         after the command, use the [F6] key.
  888.              When you do this, strange characters will be entered on the
  889.         command line which will later be replaced by their corresponding
  890.         pathname parts.  When you complete the command, PFM will execute it
  891.         just as DOS would.  When the command is finished running, a message
  892.         "Hit any key to continue" will appear.  When you strike a key, the
  893.         system will return to PFM.  In the following examples the current
  894.         drive/directory is "c:\exam", the file name is "test.asm", and the
  895.         swap directory is "a:\xxx\";
  896.  
  897.              type [F4][F3][F2]
  898.                   results in     "type C:\EXAM\TEST.ASM"
  899.  
  900.              [F1]
  901.                   results in executing the command "TEST"
  902.  
  903.              xtalk
  904.                   results in executing the command "xtalk"
  905.  
  906.              masm [F1],[F1],[F1];
  907.                   results in     "masm TEST,TEST,TEST;"
  908.  
  909.                 comp [F5][F2] [F2]
  910.                   results in     "comp A:\XXX\TEST.ASM TEST.ASM"
  911.  
  912.         The command line also has the ability to remember the last several
  913.         commands that you have used.  To look at and use them, use the cursor
  914.         down arrow and/or up arrow to find the one you want.
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                           PFM INFORMATION MANUAL    PAGE 14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.         7.10 Go or [Enter]
  933.  
  934.              Allows the execution of DOS commands.  PFM uses the name portion
  935.         of the pointed file as the command.  If you try to run a "TSR" (Termi-
  936.         nate and Stay Resident) program from PFM, then PFM will have to remove
  937.         it before continuing.  It will give you the following message before
  938.         removing the command however;
  939.  
  940.         "* Error 24: TSR in memory, Hit the 'ESC' key to have PFM remove it *"
  941.  
  942.         After hitting the ESC key PFM returns to normal operation.
  943.  
  944.  
  945.         7.11 Print
  946.  
  947.              Print the pointed file on system printer.  The "lines per page"
  948.         prompt allows you to specify a page length for files which do not have
  949.         form feeds imbedded.  If your file is already paged, specify "0".  If
  950.         the file has some form feeds, then setting the lines per page will
  951.         insure that no page is longer than the specified amount.  If you want
  952.         more than one copy of the item being printed, set the number of copies
  953.         parameter to the appropriate number.  If you want a left margin added
  954.         to the printout, enter the size you want in response to the "Left
  955.         Margin size:" question.  PFM will show a "PRINTING" status in the
  956.         upper left corner of the screen until printing is complete unless you
  957.         hit another key on the keyboard.  If you do, printing halts and you
  958.         are given a chance to abort or continue the printout.  (Hitting the
  959.         space key is the best way to stop printing a file).  PFM expands TAB
  960.         characters to every eighth column, recognizes Carriage return (CR),
  961.         Line Feed (LF), and Form Feed (FF) characters.  All other characters
  962.         are sent to the printer unchanged.  Note that PFM PRINT command should
  963.         not be used to print files containing graphics or formatting commands
  964.         from more sophisticated programs (Word processors, Spreadsheets,
  965.         Windows etc.) these should only be sent to the printer directly by the
  966.         package or via the DOS "copy /b file lpt1" type of command.
  967.  
  968.         7.12 Rename [FILES]
  969.  
  970.              Change the name of the file or move file to a different directory
  971.         on the same drive.  The pathname and filename syntax is the same as
  972.         that for the copy command.
  973.              If the destination of the rename is an explicit directory (the
  974.         destination string ends in "\") then the source file will be moved
  975.         there if the destination directory exists.  If the destination is not
  976.         explicit, then PFM checks to see if it is a directory.  If it is, the
  977.         source file is moved with it's original name to the destination
  978.         directory.  If the destination is not a directory, the source file
  979.         will be moved to the destination with a new name (the last part of the
  980.         destination).
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                           PFM INFORMATION MANUAL    PAGE 15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.         7.13 Rename [DIRECTORIES]
  998.  
  999.              Change the name of the directory or move it to a different
  1000.         directory on the same drive.  The pathname and filename syntax is the
  1001.         same as that for the copy command.
  1002.              Renaming a directory to "." has no effect.  Renaming a directory
  1003.         to ".." moves it one level closer to the root directory.  Trying to
  1004.         rename "." or ".." has no effect.
  1005.              Attempting to rename (move) a directory from one drive to another
  1006.         is illegal; you can only rename on the same drive.  If you want to do
  1007.         this, use the Copy command followed by the Delete command on the
  1008.         source.  (Please be sure that everything worked before doing your
  1009.         delete!).
  1010.              If the destination of the copy is an explicit directory (the
  1011.         destination string ends in "\") then the source directory will be
  1012.         moved there if the destination directory exists.  If the destination
  1013.         is not explicit, then PFM checks to see if it is a directory.  If it
  1014.         is, the source directory is moved with it's original name to the
  1015.         destination directory.  If the destination is not a directory, the
  1016.         source directory will be moved to the destination with a new name (the
  1017.         last part of the destination).
  1018.  
  1019.              Note: DOS and PFM only allow a directory tree to go to a
  1020.              certain depth, the depth that can be displayed in 63 charac-
  1021.              ters.  In addition PFM limits the number of directories in a
  1022.              tree to 12 deep.  Attempts to rename trees deeper than this
  1023.              will result in PFM producing an error [8] "Insufficient
  1024.              memory".  The files in the tree will be renamed up to the
  1025.              point of failure, continuing to rename the unfinished direc-
  1026.              tories past this point will eventually allow a complete
  1027.              rename.
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.                           PFM INFORMATION MANUAL    PAGE 16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.         7.14 Show
  1064.  
  1065.              Displays the contents of the current file or directory on the
  1066.         screen.  If you are showing a directory, then you are also changing to
  1067.         that directory as the current directory.  See the section on SHOW for
  1068.         more details on showing a file.
  1069.  
  1070.         7.15 Your command
  1071.  
  1072.              Like "O" command above, except uses your pre-configured commands. 
  1073.         See the More Config command section for details on how to configure
  1074.         your own commands.
  1075.  
  1076.         7.16 siZe [DIRECTORIES]
  1077.  
  1078.              This command calculates the size of a directory and all of it's
  1079.         subdirectories.  The size is rounded to the allocated unit size of the
  1080.         disk, a strict addition of file sizes, would in general result in a
  1081.         smaller number.
  1082.  
  1083.         7.17 Quit
  1084.  
  1085.              Exit PFM and return to DOS.  You will be prompted with "Are you
  1086.         Sure".
  1087.  
  1088.         7.18 Other command keys
  1089.  
  1090.              PFM allows you to define other unused standard keys and most of
  1091.         the control (CTRL) keys as user definable commands.  These keys are
  1092.         defined from the "More Config Your command" menu with the other user
  1093.         commands.  When one of these keys is depressed, it will immediately
  1094.         activate the associated command just as though you had pressed the 'Y'
  1095.         command first.  For example, if the Your command list had 'W' defined
  1096.         as "WORD" (starting your word processor), then you could start the
  1097.         word processor either by pressing 'Y' and 'W', or you could start it
  1098.         by pressing 'W' alone.  This works with the unused alphabetic charac-
  1099.         ters, numbers, punctuation marks, and control characters (except for
  1100.         CTRL B, J, M).  See the More Config command section for details on how
  1101.         to configure your own commands.
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.                           PFM INFORMATION MANUAL    PAGE 17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.         8 MAIN MENU SPECIAL KEYS
  1131.  
  1132.  
  1133.  
  1134.         8.1 Function and cursor keys
  1135.  
  1136.  
  1137.         F1 - down.  This key moves the cursor (pointer) downward through the
  1138.              directory listing by 20 lines.
  1139.         F2 - up.  This key moves the cursor (pointer) upward through the
  1140.              directory listing by 20 lines.
  1141.         F3 - down.  This key moves the pointer downward through the directory
  1142.              listing by 10 lines.
  1143.         F4 - up.  This key moves the pointer upward through the directory
  1144.              listing by 10 lines.
  1145.         F5 - reread dir.  This key causes the current directory to be reread
  1146.              to update the screen.  This is done automatically after each PFM
  1147.              command unless files are marked (see MULTIFILE operations). This
  1148.              can be used when a disk has been changed or you are finished with
  1149.              any marks on the screen.  If files are marked, you will be
  1150.              prompted "Are You Sure".
  1151.         F6 - sort.  This key allows you to re-sort the directory listing.  See
  1152.              the section on SORTING for more details.
  1153.         F7 - swap display.   PFM has the ability to keep all the information
  1154.              about the directory that you are currently viewing (the primary
  1155.              display) while showing an entirely different drive or directory
  1156.              (the secondary display).  I call the process of saving the
  1157.              current display and switching to the new "swapping displays". 
  1158.              When you hit [F7] the first time, PFM prompts you for a new
  1159.              drive/path to display.  When this is done, the third line of the
  1160.              screen changes to reverse video to indicate that you are using
  1161.              the secondary display. You can do anything while the secondary
  1162.              display is shown that you can do normally.  To return to the
  1163.              primary display, hit [F7] again. When switching back, the origi-
  1164.              nal contents are displayed unchanged.  The last several directo-
  1165.              ries that you referred to can be accessed by the cursor up and
  1166.              down arrows.
  1167.         F8 - in/exclude.  This key toggles the include flag on an individual
  1168.              file.  See the MULTIFILE section for more information.
  1169.         F9 - backup directory tree.  This shows the "parent" directory of the
  1170.              current directory (the one closer to the "root"). If you at the
  1171.              "root" (x:\), this just rereads the current directory.
  1172.         F10 - multi.  This key is used to switch between single-file and
  1173.              multi-file mode.  See the MULTIFILE section for more information.
  1174.         ESC - Escape from the current operation or backup the directory tree
  1175.              if the menu is displayed.
  1176.         Home - The Home key goes to the beginning of the directory listing.
  1177.         End - The End key moves the pointer to the end of the directory
  1178.              listing.
  1179.         Up arrow - Use the cursor up arrow key to move the pointer up by one
  1180.              line.
  1181.         Down arrow - Use the cursor down arrow key to move the pointer down by
  1182.              one line.
  1183.  
  1184.  
  1185.                           PFM INFORMATION MANUAL    PAGE 18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.         Right arrow - Use the cursor right arrow key to Show a file or direc-
  1196.              tory.
  1197.         Left arrow - Use the cursor left arrow key to back up the directory
  1198.              tree (towards the root [c:\]).
  1199.         Pg Up - This key moves the cursor (pointer) upward through the direc-
  1200.              tory listing by 20 lines.
  1201.         Pg Dn - This key moves the cursor (pointer) downward through the
  1202.              directory listing by 20 lines.
  1203.         Tab - Use the Tab key to Show a file and continue a search that was
  1204.              previously tried on another file (see Showfile F6, F7 keys).
  1205.  
  1206.         8.2 ALT key Name search
  1207.  
  1208.              PFM allows you to search for a file or directory name within the
  1209.         currently displayed directory.  This is done by pressing the ALT key
  1210.         and simultaneously pressing the first few letters of the name you are
  1211.         looking for.  The first time this is done, PFM re-sorts the directory
  1212.         according to the filename order.  If there is a match, the search name
  1213.         is put in the header bar to allow you to add additional characters to
  1214.         search for.  If there is no match, then PFM will move the cursor to a
  1215.         point alphabetically after the search name and will return the header
  1216.         bar to it's normal appearance.  Note that if there are both subdirec-
  1217.         tories and files within the directory, then the search will find the
  1218.         first match after the current cursor location.
  1219.  
  1220.  
  1221.         9 MULTIFILE OPERATIONS
  1222.  
  1223.              PFM has the ability to do operations on more than one file at one
  1224.         time.  This I call "multifile" operation.  Multifile operation is
  1225.         useful for many operations.  An example of this would be to copy a
  1226.         group of files to another place.  In DOS, you would use the DOS "copy"
  1227.         command once with a wildcard filename or several times with different
  1228.         file names.  If the files you want to copy are not easily related by a
  1229.         wildcard, then typing the individual names soon gets tiresome.
  1230.              In PFM, to copy these files, you can simply mark the files you
  1231.         want in one of several ways and then switch to multifile mode and hit
  1232.         "C" for the copy command.
  1233.              One way of marking files is with the [F8] key.  You just move the
  1234.         cursor (pointer) to the file you want and hit [F8].  This will put an
  1235.         asterisk "*" next to the file.  If the file is already marked, then
  1236.         [F8] will remove the mark.  This can be used if you have only a few
  1237.         files or they are very different in name.
  1238.  
  1239.         9.1 Include/Exclude
  1240.  
  1241.              Another way to mark files is with the "Include command".  This
  1242.         command marks groups of files according your specification.  There is
  1243.         a corresponding command to un-mark files called the "eXclude command". 
  1244.         The excluding of files is especially useful if you want to copy
  1245.         everything except ".BAK" files, for example.  When you hit "I" or "X"
  1246.         for the include or exclude commands you will be prompted for your
  1247.         choice of the method to mark (un-mark) the files.
  1248.  
  1249.  
  1250.  
  1251.                           PFM INFORMATION MANUAL    PAGE 19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.         Following is a list of the choices to be had with the include or
  1262.         exclude commands;
  1263.  
  1264.         9.1.1 Before
  1265.              This choice allows you to select files before a specified
  1266.         date/time.  If you select this choice, you will be prompted for the
  1267.         date and time.  After entering the time, you will be prompted for a
  1268.         wildcard ("?" or "*") filename to match against (see below).
  1269.  
  1270.         9.1.2 After
  1271.              This choice allows you to select files after a specified
  1272.         date/time in the same manner as "Before".
  1273.  
  1274.         9.1.3 Ignore
  1275.              This choice allows you to select files regardless of the
  1276.         date/time or attribute.  You will be prompted for a wildcard ("?" or
  1277.         "*") filename to match against (see below). 
  1278.  
  1279.         9.1.4 aTtribute
  1280.              This choice allows you to select files depending on attributes. 
  1281.         You will be prompted with:
  1282.  
  1283.                   B= W= H= S=
  1284.  
  1285.            A "=" indicates that the particular attribute does not matter.
  1286.            A "+" requires that a file have an attribute to be selected.
  1287.            A "-" requires that a file NOT have an attribute to be selected.
  1288.  
  1289.         After entering the attribute selection, you will be prompted for a
  1290.         wildcard ("?" or "*") filename to match against (see below). 
  1291.  
  1292.         9.1.5 Oldmarks
  1293.              This choice re-selects any files which were selected before the
  1294.         last multifile operation.  (The files marked with a ".")  Use this to
  1295.         do multifile operations on a group of files more than once.  For
  1296.         example if you want to copy a group of files to another place and then
  1297.         delete them from the original place, use "I", "O" for include oldmarks
  1298.         to remark the files for the delete operation.
  1299.  
  1300.         9.1.6 Wildcard filename
  1301.              When you are prompted for the wildcard filename, you should
  1302.         follow the standard MSDOS wildcard name conventions.  If you want all
  1303.         files with the previously specified attribute, for example, use "*.*"
  1304.         for the wildcard.  PFM saves the last several wildcard filenames that
  1305.         you have used.  To reuse them, hit the up or down arrow keys to find
  1306.         the one you want, and hit return. 
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                           PFM INFORMATION MANUAL    PAGE 20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.         9.2 Multifile commands
  1329.  
  1330.              The following commands operate on files which have been marked
  1331.         with the "include" flag (an "*" in the 1st column next to the file
  1332.         entry).  All of the files are done in the same operation.  If you wish
  1333.         to abort the operation, hit any key on the keyboard.
  1334.  
  1335.         9.2.1 Copy
  1336.              Copy a group of marked files to a new destination. The destina-
  1337.         tion filename MUST be an incompletely specified or wildcard type name
  1338.         for reasonable operation.  If not, then you would end up copying
  1339.         several files to the same place, writing over each other.
  1340.  
  1341.         9.2.2 Delete
  1342.              Delete a group of marked files.  You must answer "Y" to the "Are
  1343.         You Sure" prompt.
  1344.  
  1345.         9.2.3 Attribute
  1346.              Change the file attributes of the marked files. The Backup,
  1347.         Write-protect, Hidden and System attributes may be changed.  To add an
  1348.         attribute, use a "+", to remove an attribute use "-", use an "=" to
  1349.         leave it alone.
  1350.  
  1351.         9.2.4 Time
  1352.              Change the file's date and time.  The date and time of a file are
  1353.         displayed in the main part of the screen.  PFM prompts you with a line
  1354.         as follows:
  1355.  
  1356.                   Date/Time: 07-30-90, 12:00:00
  1357.  
  1358.         You cannot change the date or time of a write protected file.  If a
  1359.         file is write protected (a "W" in the attributes column) then an error
  1360.         will occur.  In this case use the Attribute command to first un-
  1361.         protect the file.
  1362.  
  1363.         9.2.5 cOmmand
  1364.              Allows execution of DOS commands on the marked files.   Use the
  1365.         F1 and F2 keys to indicate insertion of the filename into your com-
  1366.         mand.  Do not change the current directory or default disk within your
  1367.         command without restoring it or PFM will get very confused.
  1368.  
  1369.         9.2.6 Print
  1370.              Print the marked files.  The "lines per page" prompt allows you
  1371.         to specify a page size for files which do not have form feeds imbed-
  1372.         ded.  If your file is already paged, specify "0".
  1373.  
  1374.         9.2.7 Rename
  1375.              Change the name on the marked files to that specified.   The new
  1376.         filename MUST be a wildcard type name or a new directory on the same
  1377.         disk.
  1378.  
  1379.         9.2.8 Your command
  1380.              Like "cOmmand" above, except uses your pre-configured commands.
  1381.  
  1382.  
  1383.                           PFM INFORMATION MANUAL    PAGE 21
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.         10 MORE MENU
  1395.  
  1396.              These commands are accessed by hitting "M" on the main menu. 
  1397.         They are generally not related to the directory being shown.
  1398.  
  1399.         10.1 Show
  1400.  
  1401.              This command allows selection of a new directory path and/or
  1402.         drive to display.  You will be prompted for the new path which does
  1403.         not require a trailing "\".  The last several directories that you
  1404.         have used are available with the cursor up and down keys.
  1405.  
  1406.         10.2 Config PFM
  1407.  
  1408.              This command allows you to setup PFM with your own system config-
  1409.         uration.  The editor PFM uses can be changed and you can also config-
  1410.         ure some of your own commands through here.  See the section on YOUR
  1411.         COMMANDS for more information on their configuration.  PFM also saves
  1412.         many of the "text" entries which you type while using PFM (such as old
  1413.         commands, copy destinations, show file search strings, etc.)  You may
  1414.         want to check and clean up some of these before answering 'Y' to the
  1415.         "OK" question at the end of the config process.  The final configura-
  1416.         tion is saved on disk (in the PFM.COM file itself) only when you
  1417.         answer 'Y' to the "OK" question. 
  1418.  
  1419.         10.3 Edit
  1420.  
  1421.              This command allows you to edit a file that you specify.   Enter
  1422.         the file name in response to the `Pathname:' prompt.   This is useful
  1423.         for creating new text files with your editor.  If you specify a file
  1424.         on another drive or path, PFM changes to that directory before start-
  1425.         ing the editor.  This means the editor does not require an understand-
  1426.         ing of pathnames.
  1427.  
  1428.         10.4 Make new Directory (MKDIR)
  1429.  
  1430.              This command allows the creation of a new subdirectory.   The
  1431.         path should not be terminated by a "\".  The new directory will be
  1432.         displayed.
  1433.  
  1434.              Note: DOS and PFM only allow a directory tree to go to a
  1435.              certain depth, the depth that can be displayed in 63 charac-
  1436.              ters.  In addition PFM limits the number of directories in a
  1437.              tree to 12 deep.  Attempts to create (via MKDIR) trees
  1438.              deeper than this may result in PFM producing an error [8]
  1439.              "Insufficent memory".
  1440.  
  1441.         10.5 siZe
  1442.  
  1443.              This command calculates the size of all directories and all of
  1444.         their subdirectories starting from the current level.  The size is
  1445.         rounded to the allocated unit size of the disk, a strict addition of
  1446.         file sizes, would in general result in a smaller number.
  1447.  
  1448.  
  1449.                           PFM INFORMATION MANUAL    PAGE 22
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.         11 SORTING
  1461.  
  1462.              The sort command [F6] is used to sort the directory listing in
  1463.         some useful order.  Unless the directory is left unsorted, any subdi-
  1464.         rectories present in a directory are placed at the top of the display
  1465.         and any files that are marked to be included in a multi-file operation
  1466.         are placed next.  Beyond that, the following orders are provided:
  1467.  
  1468.         11.1 Name
  1469.  
  1470.              The directory listing is sorted in alpha-numeric order with the
  1471.         filename given first priority.  That is, all files with the same first
  1472.         name will be together.
  1473.  
  1474.         11.2 Extension
  1475.  
  1476.              The directory list is sorted in alpha-numeric order with the file
  1477.         extension given first priority.  That is, all of the files with the
  1478.         same extension will be together.
  1479.  
  1480.         11.3 Size
  1481.  
  1482.              The directory list is sorted in reverse order of file size.   The
  1483.         largest files will appear closest to the top of the listing.
  1484.  
  1485.         11.4 Time
  1486.  
  1487.              The directory list is sorted in reverse order of the file date
  1488.         and time.  The newest files will appear closest to the top of the
  1489.         listing.  Files with the same time will appear in alpha-numeric order
  1490.         with the filename given first priority.
  1491.  
  1492.         11.5 Don't sort
  1493.  
  1494.              Files are left in their unsorted order (the order that they are
  1495.         on the disk.)  Since PFM default is to sort files, you must use [F5]
  1496.         to reread the directory in order to see the files in the original
  1497.         order after you first select this sort method.
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.                           PFM INFORMATION MANUAL    PAGE 23
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.         12 PFM CONFIGURATION
  1527.  
  1528.              To change some of the configurable items for PFM, use the "More
  1529.         Config" ("MC" characters) from the main PFM screen.  PFM will then put
  1530.         up it's title message and a prompt line asking for you to hit one of
  1531.         the characters [H] for help, [E] for editor name, [C] for color, [U]
  1532.         for cUrsor, [Y] for Your commands, or [ESC] to exit from this menu.
  1533.  
  1534.         12.1 Help
  1535.  
  1536.              If you enter "H" a help screen will appear which will remind you
  1537.         how to answer the other questions and configuration information.  (To
  1538.         exit HELP, hit the [F10], [Enter], or [ESC] keys).
  1539.  
  1540.         12.2 Editor name
  1541.  
  1542.              If you enter "E", PFM asks the name of the text editor that you
  1543.         generally use.
  1544.              The requirements for the editor are that it be started as a
  1545.         ".COM" or ".EXE" file, it must accept the file to be edited as a
  1546.         command line input, and it must be able to locate it's own overlays
  1547.         and help files (if any) when they are not on the current disk or in
  1548.         the current directory.  The DOS editor EDLIN.COM can be used but there
  1549.         are many better ones available (such as PMATE, Microsoft WORD, or
  1550.         WordPerfect).
  1551.              Enter the name and location of your editor as the example shows.
  1552.         Remember to type the entire pathname including drive.
  1553.  
  1554.              Example:  Editor pathname: C:\DOS\EDLIN.COM
  1555.  
  1556.         This entry specifies the editor used by PFM when you want to edit a
  1557.         file.
  1558.  
  1559.         12.3 Cursor configuration
  1560.  
  1561.              If you enter a "U" for cursor, then PFM asks is whether you want
  1562.         to keep the original cursor provided by DOS when you return to DOS
  1563.         later on.  Since I happen to like a large blinking cursor (the better
  1564.         to find it on the screen) PFM will make the cursor that way unless you
  1565.         specifically answer "Y" to this question.
  1566.  
  1567.              Example:  Keep original cursor? (Y/N): N
  1568.  
  1569.         12.4 Color choice
  1570.  
  1571.              If you enter a "C" for color choice, then PFM will put up several
  1572.         lines of text in the current color scheme.  You are then asked if you
  1573.         like the scheme.  If you do, answer "Y" to the question.  PFM then
  1574.         uses the scheme from then on until you change it with another configu-
  1575.         ration.  If you don't like the colors, answer "N".  There are several
  1576.         choices of color schemes available, if you don't like any of them,
  1577.         pick the one you hate the least and write me a letter describing what
  1578.         you would like.  If you send lots of money and I am in a good mood,
  1579.         maybe I'll add your scheme to an upcoming version of PFM.
  1580.  
  1581.                           PFM INFORMATION MANUAL    PAGE 24
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.         12.5 Your commands
  1592.  
  1593.              The remaining configuration item is "Y" for Your commands.  This
  1594.         refers to the setup of your own special commands.  This is described
  1595.         in detail in a later section (YOUR COMMANDS).  If you decide to try it
  1596.         now, then you can get out by just hitting the "ESC" key.
  1597.  
  1598.              Example:  ESC or Your command Char?  [ESC]
  1599.  
  1600.  
  1601.         12.6 [ESC], [Enter] begin normal operation
  1602.  
  1603.              If all of the other configuration items are to your liking, then
  1604.         hit [ESC] or [Enter] from the menu line.  PFM then asks is if the
  1605.         above configuration answers are correct. The answers to all these
  1606.         questions and other settings will be saved with PFM if you answer "Y". 
  1607.         If you don't answer "Y", then the answers will only last until you
  1608.         quit.  (You can come back and change your mind later before you quit).
  1609.  
  1610.         PFM will begin normal operation by displaying the sign-on advertise-
  1611.         ment.  Hit [F10], [Enter], or [ESC] to begin operation and PFM will
  1612.         display the main directory and menu screen.
  1613.  
  1614.              Note: PFM saves several items other than those listed above
  1615.              when it is configured.  These include the cOmmand line
  1616.              stack; the Copy and Rename stack; the More Show directory
  1617.              and [F7] Swap directory stack; the show file Show mode, Line
  1618.              size, [F6] search stack, and + or - line count; the Print
  1619.              options; Include or eXclude options and filename stack; most
  1620.              recently used Attribute input, and Time/date input.  When
  1621.              you configure PFM, you might make sure that these are set to
  1622.              desirable settings because each time you restart PFM it will
  1623.              come up with the same settings.  If you have been working
  1624.              with PFM for a while and many of these settings have been
  1625.              changed, it might be easier to quit and restart PFM before
  1626.              doing the configure than to reset them.
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.                           PFM INFORMATION MANUAL    PAGE 25
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.         13 SHOW FILE
  1659.  
  1660.              The show file portion of PFM is one of it's best features (I
  1661.         think) in that you can show most any file, regardless of content. 
  1662.         Many files, particularly binary or executable ones, will appear as so
  1663.         much garbage with this utility, but even then, you can still see some
  1664.         interesting things.  Note: This version of PFM has some new limits on
  1665.         the size of the files that can be shown.  This is due to changes made
  1666.         to allow for word wrap.  The main limit is in the number of lines that
  1667.         can be viewed - the size of memory available to PFM minus about 80000. 
  1668.         (Your line count may vary!)  In the various modes this corresponds to
  1669.         different file sizes.
  1670.  
  1671.         13.1 Show file commands
  1672.  
  1673.              Following are a list of the commands available from the Show file
  1674.         menu;
  1675.  
  1676.         13.1.1 Top
  1677.              This command shows the file starting at the beginning.
  1678.  
  1679.         13.1.2 Bottom
  1680.              This command shows the end of the file.
  1681.  
  1682.         13.1.3 Line size
  1683.              This command tells PFM how many characters per line you like for
  1684.         the Fixed and Wrap modes.  Values less than 80 leave some space on the
  1685.         edge of the screen, values greater than 80 require the use of the left
  1686.         and right arrow keys to see the entire length of the lines.  The
  1687.         default line size is 80 when PFM is shipped, but this may be changed
  1688.         and the change saved by doing a Config PFM after the change.  The
  1689.         maximum line size is 254.
  1690.  
  1691.         13.1.4 Quit
  1692.              This command ends Show File and returns to the PFM main menu.
  1693.  
  1694.         13.1.5 +n lines
  1695.              This command allows you to move forward through the file by the
  1696.         number of lines that you specify.  Simply press the + key and enter
  1697.         the number that you want followed by a return.
  1698.  
  1699.         13.1.6 -n lines
  1700.              This command allows you to move backward through the file by the
  1701.         number of lines that you specify.  Simply press the - key and enter
  1702.         the number that you want followed by a return.
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.                           PFM INFORMATION MANUAL    PAGE 26
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.         13.1.7 Variable lines
  1724.              This command displays the file in text mode, that is, CR, LF, and
  1725.         TAB are interpreted in the usual manner. If you select this mode, PFM
  1726.         will show all subsequent files in this mode until another mode is
  1727.         selected.  Variable lines is the default mode.  The maximum length of
  1728.         any line is 254 characters.  If any line is longer it wraps to the
  1729.         next line.  If some of those characters are Tabs, then the line may be
  1730.         longer than 254 on the display.  (In earlier versions of PFM, the line
  1731.         length was not limited or limited to 2048 characters).
  1732.  
  1733.         13.1.8 Word Wrap
  1734.              This command displays the file in text mode, that is, CR, LF, and
  1735.         TAB are interpreted in the usual manner.  However, if the line being
  1736.         displayed is longer than "Line size", the last word or words are
  1737.         wrapped to the next line.  If there are no convenient breaks for the
  1738.         word wrap in the last 1/4 of the line, then the line is just cut at
  1739.         the end and wrapped to the next line.  If you select this mode, PFM
  1740.         will show all subsequent files in this mode until another mode is
  1741.         selected.  If you want to wrap at other than the default 80 charac-
  1742.         ters, change the Line size.
  1743.  
  1744.         13.1.9 Fixed lines
  1745.              This command displays the file "Line size" chars per line ignor-
  1746.         ing the meaning of the characters.  Use this mode to display binary
  1747.         data files or files without any carriage returns.  If you select this
  1748.         mode, PFM will show all subsequent files in this mode until another
  1749.         mode is selected.  This may be particularly useful for showing some
  1750.         database files with fixed record length.
  1751.  
  1752.         13.1.10 Showmode
  1753.              This command allows you to change the way files are displayed. 
  1754.         Once you select a mode, PFM will show all subsequent files in the
  1755.         mode.  The available modes are:
  1756.  
  1757.              *  7 bit ASCII codes.  This is the default mode.
  1758.              *  8 bit IBM-PC codes.
  1759.              *  7 bit ASCII with highlight on eighth bit set and tab and space
  1760.              filling.  Carriage Returns and Line feeds and Nulls are displayed
  1761.              so that they can be easily distinguished in the text modes; in
  1762.              the Fixed and heX modes, only Nulls are special.
  1763.  
  1764.         13.2 Show file special keys
  1765.  
  1766.  
  1767.         ESC - This command ends Show File and returns to the PFM main menu.
  1768.         Home - This command shows the file starting at the beginning.  
  1769.         End - This command shows the end of the file.
  1770.         Down arrow - Moves the cursor down one line.
  1771.         Up arrow - Moves the cursor up one line.
  1772.         Right arrow - Move the screen window sideways to the right by eight
  1773.              columns to see long lines.
  1774.         Left arrow - Move the screen window sideways to the left by 8 columns.
  1775.         Pg Dn - Move the pointer forward through the file by 20 lines.
  1776.         Pg Up - Move the pointer backward through the file by 20 lines.
  1777.         F1 - Move the pointer forward through the file by 20 lines.
  1778.  
  1779.                           PFM INFORMATION MANUAL    PAGE 27
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.         F2 - Move the pointer backward through the file by 20 lines.
  1790.         F3 - Move the screen window sideways to the left by 8 columns.
  1791.         F4 - Move the screen window sideways to the right by eight columns to
  1792.              see long lines.
  1793.         F5 - Move the screen window sideways all the way to the left.
  1794.         '/' -
  1795.         F6 - Search for a string in the file.  You will be prompted for the
  1796.              search string.  The cursor will stop on the line containing the
  1797.              beginning of the string or the end of the file if not found.
  1798.                   In Fixed or heX modes, matching is exact.  You must enter
  1799.              your search string with the correct case and any other characters
  1800.              exactly as in the file.  The search string can include all
  1801.              characters from 0 to 255 decimal or 0 to FF hex.
  1802.                   In Variable or Wrapped modes, matching is case insensitive,
  1803.              the high bit of all characters is ignored, and a single space
  1804.              matches one or more tabs, spaces, or other control characters. 
  1805.              Do not enter control characters, or those with the high bit set,
  1806.              or more than one sequential space in your search string.  This
  1807.              would prevent PFM from finding anything.
  1808.                   If you want to enter special characters in hex, hit F1 while
  1809.              editing the search string and enter the numbers that correspond
  1810.              to the characters to be searched.  Separate additional hex inputs
  1811.              by a single space.  To return to ASCII entry, enter F1 or any non
  1812.              hex input.  Any other characters after that will be matched di-
  1813.              rectly.  If you want to enter special characters in decimal, hit
  1814.              F4 instead of F1.
  1815.                   For example, in Fixed or heX mode, to search for the string
  1816.              "CR,LF,'hello',BS,Null" enter "F10d 0aF1helloF48 0".  This would
  1817.              be displayed as " 0d 0a hello 8 0".
  1818.                   In Variable or Wrapped modes, the string "HELLO WORLD" would
  1819.              match "hello ",TAB,"  world", "Hello",CR,LF,TAB,"World", or
  1820.              0C8h,"ELLO    ",0D7h,"ORLD" (the first character of each word has
  1821.              high bit set).
  1822.         Tab -
  1823.         F7 - Repeat the last Search, "+", or "-" command again.  When used for
  1824.              Searches, this can even be used to find a string in more than one
  1825.              file.  By using "Tab" in the main screen, a file will be shown
  1826.              and the last search repeated in a single operation.  See
  1827.              "Shift Tab" below for an easy two key file search operation.
  1828.         Shift Tab - This key exits Show file and advances the cursor to the
  1829.              next file on the main screen.  When used with Tab this will
  1830.              enable easier multiple file searches for a string.
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.                           PFM INFORMATION MANUAL    PAGE 28
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.         14 YOUR COMMANDS
  1857.  
  1858.              PFM allows the user to configure a set of commonly used one line
  1859.         commands as part of itself so that lazy typists (like me) can use a
  1860.         one or two character sequence instead of a longer command line entry. 
  1861.         To use one of these sequences, hit "Y" from the main menu.  The
  1862.         available commands will be displayed along the right side of the
  1863.         screen preceded by their command characters.  To select one, just hit
  1864.         the appropriate command character.
  1865.              If the defined command uses a character that is otherwise unused
  1866.         by PFM for a command, then you can also run the command by just
  1867.         hitting that character.  It is also possible to use control (CTRL)
  1868.         characters in the command list.  These are set up and used just like
  1869.         any other character except that they display with inverse video in the
  1870.         command list.
  1871.              To set up or change your own "Y" commands, use the "M", "C", "Y"
  1872.         (More Configure Your) commands from the main menu to get to the
  1873.         configuration screen.  When the following line prompts, enter a
  1874.         command character which will go with the "Y";
  1875.  
  1876.                   ESC or Your command Char? 
  1877.  
  1878.         If you do not want to enter or change your own commands, hit [ESC].
  1879.         Otherwise you will then be prompted for the text of your command.
  1880.         Enter as you would on the usual command line, including the [F1] to
  1881.         [F7] keys.  Delete everything on the line if you want to remove an old
  1882.         command.  When you are finished entering the command hit return.  If
  1883.         you have more commands to enter, repeat the process.  When you are
  1884.         done, hit [ESC] twice and you will be prompted with an "OK (Y/N)?". 
  1885.         Your configured commands and other changeable settings will be saved
  1886.         with PFM if you answer "Y" to the OK? at the end of the configuration.
  1887.         If you don't answer "Y", then the new settings will only last until
  1888.         you quit.
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.                           PFM INFORMATION MANUAL    PAGE 29
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.         15 LINE EDITING
  1923.  
  1924.              Whenever PFM prompts you for a response which requires more than
  1925.         a single character, it allows you to use the keys on the cursor pad
  1926.         and some others to help you change the line you are entering.  The
  1927.         entry fields are generally long enough for their normal use, but if
  1928.         you try to go beyond the end, the cursor will refuse to do it.  Input
  1929.         data can be entered in upper or lower case, for cOmmands the case will
  1930.         be preserved, for all others the entry will be converted to upper
  1931.         case.
  1932.  
  1933.         15.1 Special line editing keys
  1934.  
  1935.              Following are the keys and what they do:
  1936.  
  1937.         Right arrow - move the cursor to the right nondestructively until the
  1938.              end of the current entry is reached.
  1939.         ctrl Right arrow - move the cursor to the next "word" to the right or
  1940.              the end of the line if this is the last word.
  1941.         Left arrow - move the cursor to the left nondestructively until the
  1942.              beginning of the entry is reached.
  1943.         ctrl Left arrow - move the cursor to the beginning of the previous
  1944.              word or the beginning of the entry if appropriate.
  1945.         Backspace - delete the character to the left of the cursor.
  1946.  
  1947.         Del - delete the character under the cursor.
  1948.  
  1949.         Ins - go into insert mode until a special character is entered. 
  1950.              Characters are inserted before the current cursor location.
  1951.         Tab right - move the cursor to the end of the entry.
  1952.  
  1953.         Tab left - move the cursor to the beginning of the entry.
  1954.  
  1955.         Home - move the cursor to the beginning of the entry.
  1956.  
  1957.         End - move the cursor to the end of the entry.
  1958.  
  1959.         Ctrl End - delete from the cursor to the end of the line.
  1960.  
  1961.         Ctrl Enter - delete from the cursor to the end of the line and return.
  1962.  
  1963.         Enter - take the current entry as it is.  (return does not need to be
  1964.              at the end of the line).
  1965.         Esc - Ignore the current entry and exit from command.
  1966.  
  1967.         Up arrow - For those prompts which "remember" your last several
  1968.              entries, this goes through them in order of age.
  1969.         Down arrow - Like the Up arrow  above, except that your next newest
  1970.              entry is displayed.
  1971.         Ctrl Home - For those prompts which "remember" your last several
  1972.              entries, this will remove all of the remembered entries (usually
  1973.              used before configuring to "clean house").
  1974.  
  1975.  
  1976.  
  1977.                           PFM INFORMATION MANUAL    PAGE 30
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.         15.2 Line editing Function Keys
  1988.  
  1989.              The following function key usage is only applicable when entering
  1990.         or viewing a cOmmand, Copy, or Rename input line.
  1991.  
  1992.         [F1]  - This produces an open face character while editing the input
  1993.              which will be replaced with the name portion of the pointed file.
  1994.         [F2]  - This produces a closed face character while editing the input
  1995.              which will be replaced with the name and extension (name.ext)
  1996.              portion of the pointed file.
  1997.         [F3]  - This produces a heart character while editing the input which
  1998.              will be replaced with the currently viewed directory.  The
  1999.              directory is listed in the lower left corner of the screen along
  2000.              with the drive letter.
  2001.         [F4]  - This produces a diamond character while editing the input
  2002.              which will be replaced with the currently viewed drive.  The
  2003.              drive is listed in the lower left corner of the screen along with
  2004.              the current directory.
  2005.         [F5]  - This produces a up/down arrow character while editing the
  2006.              input which will be replaced with the swap drive and directory. 
  2007.              This is listed in the lower right corner of the screen.
  2008.         [F6]  - This key (only useful for commands) prevents PFM from asking
  2009.              for you to 'Hit any key to continue' when the command is finished
  2010.              executing.  It produces a paragraph character when editing.
  2011.         [F7]  - This produces a club character while editing the input which
  2012.              will be replaced with the extension portion of the pointed file.
  2013.         [F10] - Help.  This key is actives this help screen.
  2014.  
  2015.         The keys [F1] to [F7] will put special characters into the entry which
  2016.         will only be meaningful in cOmmands, Copy, and Rename.  At other
  2017.         times, they may cause strange errors.  Other special keys will be
  2018.         ignored.
  2019.  
  2020.         16 ERRORS
  2021.  
  2022.              PFM tries to make error handling as easy as possible.  If an
  2023.         error occurs during normal operation which DOS would let you fix and
  2024.         retry, PFM also lets you fix and retry or abort.  If the error is such
  2025.         that a retry is not reasonable, an error code is displayed and you are
  2026.         given a chance to look at the error help list or just to return to the
  2027.         menu.  Following is a list of the error codes that you might get and
  2028.         what they might mean.  If you get a code that is not in the list, then
  2029.         try looking up the code in your DOS manual (you may have a different
  2030.         DOS than I do).
  2031.  
  2032.         1  - DOS invalid function.  This shouldn't happen, contact program
  2033.              support.
  2034.         2  - File not found.  The disk has been changed or perhaps the editor
  2035.              is not present where it was configured to be.
  2036.         3  - Path not found.  Possibly invalid syntax, remember, no trailing
  2037.              "\" on "More MKDIR" command.
  2038.         4  - DOS error, too many files open.  See your DOS manual on system
  2039.              configuration. (CONFIG.SYS)
  2040.  
  2041.  
  2042.  
  2043.                           PFM INFORMATION MANUAL    PAGE 31
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.         5  - Access Denied or protection violation.  This usually means you
  2054.              are trying to write or delete a "write-protected" file. Use the
  2055.              "Attribute" command to un-protect the file.  It can also happen
  2056.              with "Network" disk drives for which you have no access rights.
  2057.         6  - DOS error, Invalid file handle.  This shouldn't happen, contact
  2058.              program support.
  2059.         7  - DOS error, Memory control blocks destroyed.  Something has gone
  2060.              very wrong, you had better reboot.
  2061.         8  - DOS/PFM error, Insufficient memory for program.  When running a
  2062.              command, the program might work if you "Quit" PFM first to open
  2063.              up some more memory and then run in the old fashioned DOS way. 
  2064.              If you get this error in Show file, then the file is too large
  2065.              for PFM to completely display.  You may also get this error while
  2066.              doing operations on very large directories, with very large
  2067.              numbers of files.  You may also get this error while doing
  2068.              operations on very deep directory trees, if so, retry the opera-
  2069.              tion on deeper portions of the tree first.
  2070.         10 - DOS error, Invalid environment.  Something has gone very wrong,
  2071.              you had better reboot.
  2072.         11 - DOS error, Invalid format.  Who Knows???
  2073.         12 - DOS error, Invalid Access code.  Who Knows???
  2074.         13 - DOS error, Invalid Data.  Who Knows???
  2075.         15 - Invalid Drive number specified.  You probably specified a drive
  2076.              letter higher than you should have.
  2077.         16 - Cannot delete the current directory.  If you really want to,
  2078.              first delete all the files and other directories in it first.
  2079.         17 - Cannot rename from one device to another.  The only way to do
  2080.              this is to copy to the other device and then delete the original.
  2081.         18 - No more files available in the directory.  That just about says
  2082.              it all.
  2083.         19 - No more room on the disk.  That just about says it all.
  2084.         21 - Incorrect syntax in operator entry.  PFM doesn't like the syntax
  2085.              of the Date/time entry or maybe of an attribute spec.
  2086.         22 - Cannot copy a file to itself.  Since this would generally destroy
  2087.              the file, PFM will not let you do this.
  2088.         23 - Cannot show an empty file.
  2089.         24 - Cannot load a permanent memory resident task from PFM. Some
  2090.              programs (like PFM) leave parts of themselves in memory all the
  2091.              time after they are loaded.  An example is the DOS PRINT utility.
  2092.              Since PFM uses memory in a simple minded way, programs such as
  2093.              these can not be run from PFM.  Sometimes programs such as the
  2094.              PRINT utility can be loaded once before starting PFM (like in an
  2095.              AUTOEXEC.BAT) and will then run normally when called by PFM
  2096.              afterwards.  PFM will remove the program from memory when you
  2097.              "Hit any key".
  2098.         55 - Operator abort of a disk error operation.  If you get a disk
  2099.              error and specify the "abort" or "ignore" choices, then you will
  2100.              also get this error message.  Just hit the [Esc] key and keep
  2101.              going.
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.                           PFM INFORMATION MANUAL    PAGE 32
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.         17 REVISION HISTORY
  2120.  
  2121.              The following items have changed since version 2.22 of PFM:
  2122.  
  2123.         2.23 - If screen modes are switched by a command, the message "Hit any
  2124.              key to continue" is not properly displayed. (fixed).
  2125.  
  2126.         2.24 - Would like to be able to rename directories.  (Directory rename
  2127.              added [but not Move])
  2128.  
  2129.         2.25 - Would like to be able to refer to the other (swap) directory
  2130.              from where I am in the copy, rename, and command operations. 
  2131.              (added F5 function to Command, Copy, Rename) 
  2132.  
  2133.         2.26 - Would like a stack of directory names to refer to for F7 and
  2134.              More Show commands.  Would be nice if the standard default was A:
  2135.              though. (Added)
  2136.  
  2137.         2.27 - Would like to see PFM work right with 43 line EGA displays.
  2138.              (fixed [but causes problems with ATT machines, see v2.30 and
  2139.              v3.10]).
  2140.  
  2141.         2.26 - Disk size displayed by PFM on my optical drive (144 mbyte) is
  2142.              messed up.  First digit is an unusual character, last digits
  2143.              appear to be correct. (fixed by increasing to max of 999,999,999)
  2144.  
  2145.         2.28 - DOS gets confused following a delete operation to a write
  2146.              protected disk.  The displayed directory is incorrect and other
  2147.              strange behavior occurs.  Fixed by using Disk reset to clear DOS
  2148.              after an unusual error.
  2149.  
  2150.         2.29 - Don't want to hit CR after all my commands to get back to PFM. 
  2151.              (use F6 on command line) 
  2152.  
  2153.         2.29 - Fix problem where more than one screen full of multifile
  2154.              commands does not scroll up correctly.  (Fixed by correcting
  2155.              Mixed DOS/PFM screen handlers). 
  2156.  
  2157.         2.30 - It has been reported that some of the newer versions of PFM do
  2158.              not work properly with ATT machines.  The problem seems to stem
  2159.              from an incompatibility with the IBM standard regarding the
  2160.              location in memory of the size of the screen.  PFM picks up a
  2161.              value which is apparently not the correct number of screen rows. 
  2162.              To fix this problem a patch is required.  Starting with an
  2163.              original copy of PFM.COM or IBMPFM.COM;   !!! DO NOT ATTEMPT THIS
  2164.              WITHOUT SAVING YOUR ORIGINAL COPY OF PFM.  SUGGEST ONLY EXPERI-
  2165.              ENCED PEOPLE ATTEMPT THIS !!! Search for the following sequence
  2166.              with a debugger (DOS debug works):
  2167.                        3C 19 77 03 B8 19 00 A3 
  2168.              Starting at the last byte (A3) change three bytes to:
  2169.                        90 90 90
  2170.              The sequence should now look like this: 
  2171.                        3C 19 77 03 B8 19 00 90 90 90 
  2172.              This should force PFM to always set up the screen for 25 line
  2173.              mode and prevent the problems reported. 
  2174.  
  2175.                           PFM INFORMATION MANUAL    PAGE 33
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.         2.31 - Showing a binary file which contains many characters before the
  2186.              first line feed in variable line mode can take forever (especial-
  2187.              ly with very large files).  The fix is to limit line length to
  2188.              2048 chars in variable mode, the show then displays an error and
  2189.              switches to fixed mode. 
  2190.  
  2191.         3.00 - Allow F1... to be used in Copy and rename commands. 
  2192.  
  2193.         3.00 - Copying to a file that already exists but has a newer date/time
  2194.              PFM now asks for permission.
  2195.  
  2196.         3.00 - Allowed copy, delete, and rename of subdirectories.
  2197.  
  2198.         3.00 - Get 'Y' commands and editor pathname from old PFM when doing an
  2199.              update.
  2200.  
  2201.         3.00 - Added code to remove TSRs from memory following a command.
  2202.  
  2203.         3.07 - Greatly reduced PFM's memory requirement when running commands
  2204.              or the editor.  This was done at the expense of reloading PFM's
  2205.              code after the command thus slowing operations slightly.
  2206.  
  2207.         3.07 - Make Enter key run the pointed file as a command (also Go).
  2208.  
  2209.         3.07 - Added file date/time modify.
  2210.  
  2211.         3.07 - Would like a method of configuring color choice, and user
  2212.              settings from a file so that upgrades can be accomplished more
  2213.              easily.  Color choice configuration should be much easier. 
  2214.              (added several color schemes and method of selecting them).
  2215.  
  2216.         3.07 - PFM does not properly display disk and file size greater than
  2217.              999,999,999 bytes.  This is fixed by switching to Kb displayed
  2218.              above this limit.
  2219.  
  2220.         3.07 - PFM does not properly show dates after year 1999.  Fixed; year
  2221.              2000 now shows 01-01-00.
  2222.  
  2223.         3.09 - Would like a mode of Showfile like 'F'ixed, but where CRLFs
  2224.              (and TABs ?) are understood.  This would be useful for viewing
  2225.              crazy word processor output that has mile-long paragraphs which
  2226.              contain no explicit CRLFs.  It would 'F'ix (wrap) the text of the
  2227.              paragraphs but leave other line formatting alone.  This was fixed
  2228.              by adding Wrap to show file.
  2229.  
  2230.         3.09 - Would like a mode of Showfile like 'F'ixed, but where the
  2231.              binary data is displayed in Hex.  This was fixed by adding heX to
  2232.              show file.
  2233.  
  2234.         3.09 - Searching for text and binary data is made easier and more
  2235.              robust with the Show file search command F6.
  2236.  
  2237.         3.09 - Attempts to rename a directory to a different drive are now
  2238.              considered errors.
  2239.  
  2240.  
  2241.                           PFM INFORMATION MANUAL    PAGE 34
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.         3.10 - Corrected bug in Time entry; corrected bug in showfile heX mode
  2252.              address display;
  2253.  
  2254.         3.10 - Fixed up screen size (number of rows) operations for certain
  2255.              partly compatible (ATT) machines.  Added screen border.
  2256.  
  2257.         3.10 - Can move directly to the file or directory by typing the first
  2258.              few characters of the file name with the ALT key pressed.
  2259.  
  2260.         3.10 - Allow otherwise unused letters/numbers to be configured by
  2261.              user. 
  2262.  
  2263.         3.10 - F8 key marks file and then moves to the next file.
  2264.  
  2265.         3.10 - Rename and Copy directory now lists each file during operation
  2266.              (makes it easier to see where errors occur).
  2267.  
  2268.         3.10 - Moving up/down directory tree on a single drive and between
  2269.              drives has been improved for better handling of the cursor; it
  2270.              tends to stay where you left it for each drive.  It is now
  2271.              possible to config and have main screen cursor to return to where
  2272.              it was on config.
  2273.  
  2274.         3.10 - Increase Show File line limit to depend on available memory,
  2275.              new limit is PFM's available memory size - ~80000 with variation
  2276.              for the number of files in the current directory and versions of
  2277.              PFM.
  2278.  
  2279.         3.10 - Make new directory leaves cursor at end of current directory.
  2280.  
  2281.         3.10 - Fixed bug where screen gets messed up following a command.
  2282.  
  2283.         3.10 - Put error checking on memory usage so that trying to display an
  2284.              excessive number of files doesn't crash.
  2285.  
  2286.         3.10 - Increased screen size for 'Y' command display, can now handle 3
  2287.              columns.
  2288.  
  2289.         3.11 - Increased memory available for 'Y' commands and reduced the
  2290.              memory penalty for small numbers of 'Y' commands.
  2291.  
  2292.         3.11 - "More siZe" updates current directory size on main screen and
  2293.              no longer sizes the "." directory, increasing speed on slow hard
  2294.              disks.
  2295.  
  2296.         3.11 - Fixed failure/crash caused by doing directory operations on
  2297.              very deep directory trees.
  2298.  
  2299.         3.12 - Fixed failure/crash caused when working with CGA screens (bug
  2300.              created in PFM 3.10).
  2301.  
  2302.         3.12 - Fixed failure/crash caused when using HELP when in installation
  2303.              or config 'Y'our commands.
  2304.  
  2305.  
  2306.  
  2307.                           PFM INFORMATION MANUAL    PAGE 35
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.         3.12 - Fixed main screen polling of keyboard so that screen blanker
  2318.              programs can sense no activity (bug created in 3.10).
  2319.  
  2320.         3.14 - Fixed bugs that caused screen corruption in certain rare
  2321.              situations; fixed Alt key name search where search would not roll
  2322.              back to top if cursor landed on last item on screen.
  2323.  
  2324.         3.14 - Added cursor key control of directory/file show (Right arrow)
  2325.              and directory parent (left arrow).  Added Delete key for delete
  2326.              functions.  Added Tab and Shift Tab key to main screen and
  2327.              Showfile.
  2328.  
  2329.         18 IDEAS FOR FUTURE ENHANCEMENTS
  2330.  
  2331.  
  2332.         - If copying to a file which already exists and is marked hidden or
  2333.         system should not complete the copy or delete the destination file. 
  2334.          
  2335.         - Would like to add a selection mask to the show directory command,
  2336.         This might also include the attributes. 
  2337.          
  2338.         - Add an "update" function that allows copy of a file to a second
  2339.         directory only if it does not exist or is not up to date based on the
  2340.         time-stamp.  This would be faster that a complete copy (which does the
  2341.         same thing). 
  2342.          
  2343.         - Would like the swap screen to operate as a split screen, possibly
  2344.         full time. 
  2345.          
  2346.         - Would like a short form of directory display with more names on
  2347.         screen (configurable or on command) 
  2348.          
  2349.         - status display of RAM memory. 
  2350.          
  2351.         - Would like to see the volume label displayed (in with the files ?),
  2352.         if it's in the directory being viewed (root).  It would also be handy
  2353.         to manipulate the volume label (add, rename, delete) if that's easy to
  2354.         do. 
  2355.          
  2356.         - If backup past root directory, show drive letters and allow selec-
  2357.         tion. 
  2358.  
  2359.         - Pop-up PFM additions (can do all but edit, command) when entered
  2360.         (via ctrl-break?) and can return to previous program. 
  2361.          
  2362.         - Speaking of On-Screen keyboard status, how 'bout NumLock, Scroll
  2363.         Lock, and Caps Lock below the date ? 
  2364.          
  2365.         - Could you add an option that allows "SHOW" to expand tabs to some-
  2366.         thing other than eight.  All of my "C" programs use a tab setting of
  2367.         four.  This would be a big help to me and some (a few) others. 
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.                           PFM INFORMATION MANUAL    PAGE 36
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.         19 NOTICE TO USERS
  2385.  
  2386.              This is the latest release of PFM.  This and other versions are
  2387.         distributed via bulletin boards and other "grapevine" methods to
  2388.         people interested in the software package.  As I am not in the busi-
  2389.         ness to mass produce or market this or any other software and have no
  2390.         interest in doing so, I am unable to provide this program on any media
  2391.         directly.
  2392.  
  2393.              If you need a copy of the program, and are not able to find it
  2394.         via the "grapevine", then you may send me a self-addressed, stamped
  2395.         floppy mailer with an IBM compatible 5.25" diskette in it on which I
  2396.         will put the latest copy of the program and it's documentation.  I
  2397.         will return this to you typically within one work week of receiving it
  2398.         if postage, floppy, mailer, and address are all present (I once
  2399.         received a stamped mailer with floppy and with a letter and NO return
  2400.         address.  This is difficult to return.)
  2401.  
  2402.              Due to this limited support, I do not expect much in the way of
  2403.         compensation from users.  A contribution of up to $45 from individual
  2404.         users will be greatly appreciated and provides incentive to continue
  2405.         improving the product.
  2406.  
  2407.         The following provisions apply:
  2408.  
  2409.         * Upgrades, automatic, one-time or otherwise are not available except
  2410.         as indicated above.
  2411.  
  2412.         * Source code will not be given out.
  2413.  
  2414.         * I am not interested in doing customized versions of PFM.
  2415.  
  2416.         * I would like to hear about any BUGs in the software and any sugges-
  2417.         tions for improvements (most new versions are due to this input) but
  2418.         will not be responsible for any consequential damages caused by bugs.
  2419.  
  2420.         * My phone number is not listed for a good reason.
  2421.  
  2422.              For those users who have already contributed, I am sorry if there
  2423.         has been any misunderstanding about the level of support offered and I
  2424.         thank you for your contribution.
  2425.  
  2426.  
  2427.  
  2428.                                  Paul R. Culley
  2429.                                  13010 Marron Dr.
  2430.                                  Cypress, Tx 77429-2007
  2431.                  paulc@bangate.compaq.com
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.                           PFM INFORMATION MANUAL    PAGE 37
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.         20 INFORMATION ON SITE & DISTRIBUTION LICENSES
  2451.  
  2452.              Corporate and Governmental License
  2453.  
  2454.         Following is an example license for use of the software within your
  2455.         company or government agency, and is not transferable.  This allows
  2456.         internal use and copying of the software for up XX users as contracted
  2457.         for.  Distributing, repackaging, or reselling of the software to third
  2458.         parties is not allowed.  All licenses are prepaid.
  2459.  
  2460.              For corporate and Governmental users, a single payment will get
  2461.         you a "license" indicating that the software is paid for and free of
  2462.         further obligations.  This should provide your auditors and lawyers
  2463.         with a feeling of safety from litigation.  The price is as follows:
  2464.  
  2465.              users     price
  2466.              1-5       $100
  2467.              5-20      $20/user
  2468.              20 up     $1000 + $1/user
  2469.  
  2470.  
  2471.              Shareware clubs
  2472.  
  2473.         This license is not necessary for clubs or user groups distributing
  2474.         the software on a SHAREWARE basis, providing that the entire PFM
  2475.         package with accompanying documentation files is included in the
  2476.         distribution, and no more than a nominal fee (not to exceed $10) is
  2477.         charged for such distribution.
  2478.  
  2479.              Private Use
  2480.  
  2481.         There is no requirement for a license if used by individuals.  As
  2482.         indicated above, donations are appreciated.
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.                           PFM INFORMATION MANUAL    PAGE 38
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.         SAMPLE SITE LICENSE
  2516.  
  2517.  
  2518.  
  2519.                                   Paul R. Culley
  2520.                                   13010 Marron Dr.
  2521.                               Cypress, TX  77429 USA
  2522.  
  2523.         Paul R. Culley hereby grants [ORGANIZATION NAME] a license for [NUMBER
  2524.         OF USERS] users for the use of the PFM program versions up to 3.99.
  2525.  
  2526.         This is a perpetual license for the use of the software within your
  2527.         company, and is not transferable.  This license allows internal use
  2528.         and copying of the software by as many users as contracted for. 
  2529.         Distribution, repackaging, or reselling of the software, to third
  2530.         parties, is not allowed under this agreement.
  2531.  
  2532.         The LICENSOR warrants that it is sole owner of the software and has
  2533.         full power and authority to grant this license herein without consent
  2534.         of any other party.
  2535.  
  2536.         Paul R. Culley hereby disclaims all warranties relating to this
  2537.         software, whether express or implied, including without limitation any
  2538.         implied warranties of merchantability or fitness for a particular
  2539.         purpose.  Paul R. Culley will not be liable for any special, inciden-
  2540.         tal, consequential, indirect or similar damages due to loss of data or
  2541.         any other reason, even if Paul R. Culley has been advised of the
  2542.         possibility of such damages.  In no event shall Paul R. Culley's
  2543.         liability for any damages ever exceed the price paid for the license
  2544.         to use the software, regardless of the form of the claim.  The person
  2545.         using the software bears all risk as to the quality and performance of
  2546.         the software. 
  2547.         This agreement shall be construed and enforced in accordance with the
  2548.         laws of the STATE OF TEXAS.  Any action or proceeding brought by
  2549.         either party against the other arising out of or related to this
  2550.         agreement shall be brought only in a STATE or FEDERAL COURT of compe-
  2551.         tent jurisdiction located in Harris county, Texas.  The parties hereby
  2552.         consent to in personam jurisdiction of said courts. 
  2553.  
  2554.         COMPANY: ___________________
  2555.  
  2556.         ADDRESS: ______________________
  2557.  
  2558.         CITY:    _____________________  STATE:  __   ZIP CODE: _____
  2559.  
  2560.         AUTHORIZED  SIGNATURE:   _____________________________________
  2561.  
  2562.         TITLE: _______________________         DATE: _______________
  2563.  
  2564.         Paul R. Culley : _________________________  DATE: _________________
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.                           PFM INFORMATION MANUAL    PAGE 39
  2572.  
  2573.  
  2574.  
  2575.  
  2576.